home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gth035.zip / MENUCOLS.HLP < prev    next >
Text File  |  1990-07-16  |  4KB  |  92 lines
  1.  
  2. ╔═════════╦════════════════════════════════════════════════════════════
  3. ║ GT-HELP ║ Colour Codes for SYSOP.BBS, GTMDIR.BBS and GTDIR.BBS files
  4. ╚═════════╩════════════════════════════════════════════════════════════
  5.  
  6.  
  7.     These three .BBS files will support "embedded colour commands".
  8.  
  9.     Note that even if you don't *plan* on using colours in this file,
  10.     you have to take care if your text in any of these files contains
  11.     any of these special characters :
  12.  
  13.         %   $   &   [   ]   ~
  14.  
  15.  
  16. ┌──────────────────────────┐
  17. │ Embedded Colour Commands │
  18. └──────────────────────────┘
  19.  
  20.     Embedded colour commands allow a single file to control the display
  21.     for both ANSI and non-ansi callers.  If the caller has selected the
  22.     ANSI option, colour codes will be inserted.  If the caller has not
  23.     selected ANSI, then the colour codes will be stripped out and ignored.
  24.  
  25.     Essentially, there are three possible colour schemes, represented
  26.     by symbols.  The colours take their values from the GT.CNF file
  27.     but, for the purposes of this example, let us assume you have set
  28.     your colours to the "Mono-Compatible" colour set which GT-Help
  29.     offers.
  30.  
  31.                      ╔════════════════════╤═══════════════════════╗
  32.                      ║   Standard text    │     Highlit text      ║
  33.     ╔════════════════╬════════════════════╪═══════════════════════╣
  34.     ║   & (default)  ║  Option Lowlight   │   Option Highlight    ║
  35.     ║                ║       (red)        │       (yellow)        ║
  36.     ╟────────────────╫────────────────────┼───────────────────────╢
  37.     ║       $        ║    Window text     │      Select Bar       ║
  38.     ║                ║      (green)       │   (black on white)    ║
  39.     ╟────────────────╫────────────────────┴───────────────────────╢
  40.     ║   ~ (tilde)    ║     Callers own Terminal Mode Default      ║
  41.     ║                ║           (no way of knowing)              ║
  42.     ╚════════════════╩════════════════════════════════════════════╝
  43.  
  44.  
  45.     a)  Colours revert to the default colour set at the beginning of each
  46.         line.
  47.  
  48.         So, with the example colour scheme, text will normally be displayed
  49.         in RED unless it is enclosed in square brackets, in which case the
  50.         brackets are omitted and it will be displayed in YELLOW.
  51.  
  52.     b)  As an alternative, you can precede the line with a $ sign.
  53.  
  54.         In this case, text on that line will be displayed in GREEN unless
  55.         enclosed in square brackets, making it BLACK ON WHITE.
  56.  
  57.     c)  You can precede a line with a ~, turning off colour attributes
  58.         for that line.  In this case, the line will be displayed in an
  59.         "unknown" colour that is dependent on what the CALLER has
  60.         configured as the terminal mode default colour.
  61.  
  62.  
  63.  
  64.     For an easy way of understanding it, paste this text into your
  65.     GTMDIR.BBS file and display it using ANSI :
  66.  
  67.             ----------------------------------------
  68.             A default line with a [highlighted] word.
  69.             $An alternative line with a [highlighted] word.
  70.             A continuation line, showing [reversion] to default.
  71.             $Alternative with [highlight] and &early [reversion].
  72.             ~A line in Callers Terminal Mode colour.
  73.             A continuation line, showing [reversion] to default.
  74.             ----------------------------------------
  75.  
  76.  
  77.  
  78.  
  79.     Special cases:
  80.  
  81.         If you need callers to *see* any of the special characters
  82.  
  83.                 %   $   &   [   ]   ~
  84.  
  85.         you should precede them with % to prevent them from being
  86.         interpreted as colour controls.
  87.  
  88.         If you need callers to see the % sign, you should use two of them,
  89.         ie %%
  90.  
  91.  
  92.